Understanding Geospatial Analysis in VIDIZMO
VIDIZMO provides a feature that enables users to view and analyze geospatial data alongside their content. This functionality is supported for all audio, video, image, and document uploads to your Portal, making it a versatile tool for tracking the movement and location of objects, devices, or targets within your content.
By extracting KLV (Key-Length-Value) data that contains geospatial coordinates, VIDIZMO enables users to synchronize precise location data with timestamps during playback. This enables real-time geospatial analysis, whether tracking drone movements, body-worn cameras, or other content types.
Concept
Geospatial data analysis enables you to contextualize and understand the movement and location of objects within your content. To perform geospatial analysis in VIDIZMO, KLV (Key-Length-Value) data is required. When this data is available, VIDIZMO displays a map during content playback, showing the tracking of objects and other properties. These properties are reflected based on the KLV data provided. For example, if the KLV data includes a property such as Mission ID, it will be displayed on the playback page, along with the map.
The geospatial map reflects all the properties obtained from the KLV data you provide, such as location, coordinates, and object trajectory. To learn more, refer to the Analyze Geospatial Data section in How to Analyze Geospatial Data in VIDIZMO
KLV Data Extraction in VIDIZMO
Embedded KLV Data: If the content has KLV data embedded (e.g., drone footage or videos with built-in geospatial metadata), VIDIZMO automatically synchronizes this data with the video during playback. This removes the need for manual uploads.
Manual Timed Data Upload: For content without embedded KLV data, users can upload external timed data files in the following formats: .csv, .srt, or .vtt. These files contain timestamped coordinates (latitude and longitude), which VIDIZMO uses to synchronize the data with the playback timeline. The supported formats for uploading timed data are:
- For Audios/Videos: .srt, .vtt, and .csv
- For Images/Documents: .csv (single data point for location)
The CSV files must follow a specific structure with three columns: Timestamp, Longitude, and Latitude. For images and documents, only a single data point is needed, which will appear as a static location during playback, showing the location at that specific timestamp. Here is an example:
| Timestamp | Latitude | Longitude |
|---|---|---|
| 01/30/2000 20:00:00 | 38.917130 | -77.222237 |
VIDIZMO processes the coordinates with up to 6 decimal places of precision, which corresponds to a typical accuracy of about 11 centimeters. Any extra digits beyond this precision are discarded during processing
Geospatial Mapping and Playback
VIDIZMO enables users to track geospatial data through a map displayed during playback. The map offers insights into the movement of both the recording device and any targets being tracked:
For videos and audio files, the map data updates dynamically, allowing users to track the real-time movement of the device and target as your file plays.
For images and documents, a .csv file with one timestamped coordinate is all that's needed as there is no continuous data stream. This data is reflected as a static location on the geospatial map on the playback page.
Exporting Geospatial Data
Users can export geospatial data for further analysis or reporting:
For cases of content with embedded KLV data, VIDIZMO automatically extracts that data to display it on the map. Users can download the data as a .csv file directly from the map view or obtain it from the Evidence Settings page in .vtt format.
The same can be done for uploaded timed data files (e.g., .csv, .srt, .vtt). Users can export data as a .csv file from the map view or download a .vtt file from the Evidence Settings.
Troubleshooting
Common Issues: Users may face issues with incorrect file formats or missing KLV data, which can prevent geospatial data from displaying properly. Ensure that timed data files are correctly formatted with the required columns and valid timestamps.
Video Transcoding: If videos, especially those with embedded KLV data, are not displaying or playing back correctly, ensure that the file has been transcoded properly. Transcoding may be necessary for specific video file formats (e.g., .ts) to ensure compatibility with VIDIZMO's geospatial data features.